Contexto global.FindMarkedForDeletion

Contexto global

FindMarkedForDeletion

Disponible desde la versión 8.3.5.

Sintaxis:

FindMarkedForDeletion(<ÁreaDeBúsqueda>, <IncluirObjetos>, <ExcluirObjetos>)

Parámetros:

<ÁreaDeBúsqueda> (opcional)

Tipo: Array.
Determina el área de búsqueda para los objetos marcados para eliminación. El área se establece mediante una combinación de separadores, que incluyen objetos de metadatos, entre cuyos datos se realizará la búsqueda.
El elemento del array tiene el tipo Array.
El elemento del array anidado tiene el tipo de:

  • Objeto de metadatos – Atributo común, que separa los datos.
  • Cadena – nombre del atributo común que separa los datos.

De forma predeterminada, tiene el valor Undefined.
Valores posibles:

  • Undefined – se seleccionan todos los objetos de metadatos si el parámetro <IncluirObjetos> también tiene el valor Undefined. De lo contrario, es igual a pasar un array vacío.
  • Array con combinaciones de separadores que determinan el área de búsqueda.

Nota. Si la combinación de separadores contiene duplicados, se produce una excepción porque en la configuración no puede haber objetos de metadatos incluidos en el mismo separador dos veces.
Valor predeterminado: Undefined.

<IncluirObjetos> (opcional)

Tipo: Array.
Permite especificar directamente los objetos de metadatos que deben estar presentes en el área de búsqueda de referencias a objetos marcados para eliminación.
El elemento del array puede estar representado por:

  • Objeto de metadatos.
  • Cadena que es el nombre completo del objeto de metadatos.

Valores permitidos:

  • Undefined,
  • Array vacío,
  • Array de objetos de metadatos.

<ExcluirObjetos> (opcional)

Tipo: Array.
Los elementos del array pueden estar representados por:

  • Objeto de metadatos,
  • Cadena que es el nombre completo del objeto de metadatos.

Permite especificar directamente los objetos de metadatos que deben excluirse del área de búsqueda de objetos marcados para eliminación.
Valores permitidos:

  • Undefined
  • Array vacío (no se agregan objetos al área de búsqueda).
  • Array de objetos de metadatos.

Valor devuelto:

Tipo: Array.
Un array con una lista de referencias a objetos marcados para eliminación.

Descripción:

Busca todos los objetos marcados para eliminación, que están disponibles para el usuario en la sesión actual y están incluidos en el ámbito de búsqueda establecido por los parámetros <ÁreaDeBúsqueda>, <IncluirObjetos> y <ExcluirObjetos>.
Si el parámetro <ExcluirObjetos> no está definido o se utiliza el modo de compatibilidad de configuración Version8_3_4 y versiones anteriores, la búsqueda se realiza entre todos los objetos que están disponibles en la sesión actual, considerando la separación (también se considera la separación condicional). En este caso, los parámetros <IncluirObjetos> y <ExcluirObjetos> no se tienen en cuenta.
Si no se utiliza el modo de compatibilidad y los valores de los parámetros <ÁreaDeBúsqueda> y <IncluirObjetos> difieren de Undefined, el método busca todos los objetos marcados para eliminación que están disponibles para el usuario desde la sesión actual y que se encuentran dentro del área de búsqueda especificada en los parámetros <ÁreaDeBúsqueda>, <IncluirObjetos> y <ExcluirObjetos>.

La búsqueda se realiza entre los datos disponibles para el usuario: el usuario debe estar autorizado para leer el objeto, los datos se seleccionan solo después de verificar los derechos de acceso.

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.
La llamada al método ejecuta una llamada al servidor.

Nota:

En la plataforma móvil, se ignoran los parámetros <ÁreaDeBúsqueda>, <IncluirObjetos> y <IncluirObjetos>.

Ejemplo:

ObjetosMarcados = FindMarkedForDeletion(); 
Para 
Cada ItemMarcado En ObjetosMarcados Hacer 
    Message(“Marcado para eliminación: “ + ItemMarcado); 
FinHacer
;

Disponible desde:

Disponible desde la versión 8.3.5.